home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / rcs.1 < prev    next >
Text File  |  1995-07-25  |  12KB  |  331 lines
  1.  
  2.  
  3.  
  4. RCS(1)                                                     RCS(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        rcs - change RCS file attributes
  9.  
  10. SSYYNNOOPPSSIISS
  11.        rrccss [ _o_p_t_i_o_n_s ] _f_i_l_e ...
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        rrccss  creates new RCS files or changes attributes of exist-
  15.        ing ones.  An RCS  file  contains  multiple  revisions  of
  16.        text,  an access list, a change log, descriptive text, and
  17.        some control attributes.  For rrccss to  work,  the  caller's
  18.        login  name  must  be  on  the  access list, except if the
  19.        access list is empty, the caller is the owner of the  file
  20.        or the superuser, or the --ii option is present.
  21.  
  22.        Pathnames  matching  an  RCS  suffix denote RCS files; all
  23.        others  denote  working  files.   Names  are   paired   as
  24.        explained  in  ccii(1).   Revision  numbers  use  the syntax
  25.        described in ccii(1).
  26.  
  27. OOPPTTIIOONNSS
  28.        --ii     Create and initialize a new RCS file,  but  do  not
  29.               deposit  any revision.  If the RCS file has no path
  30.               prefix, try to place it first into the subdirectory
  31.               ..//RRCCSS, and then into the current directory.  If the
  32.               RCS file already exists, print an error message.
  33.  
  34.        --aa_l_o_g_i_n_s
  35.               Append the login  names  appearing  in  the  comma-
  36.               separated list _l_o_g_i_n_s to the access list of the RCS
  37.               file.
  38.  
  39.        --AA_o_l_d_f_i_l_e
  40.               Append the access list of  _o_l_d_f_i_l_e  to  the  access
  41.               list of the RCS file.
  42.  
  43.        --ee[_l_o_g_i_n_s]
  44.               Erase  the  login  names  appearing  in  the comma-
  45.               separated list _l_o_g_i_n_s from the access list  of  the
  46.               RCS  file.   If _l_o_g_i_n_s is omitted, erase the entire
  47.               access list.
  48.  
  49.        --bb[_r_e_v]
  50.               Set the default branch to _r_e_v.  If _r_e_v is  omitted,
  51.               the  default  branch  is reset to the (dynamically)
  52.               highest branch on the trunk.
  53.  
  54.        --cc_s_t_r_i_n_g
  55.               sets the comment leader  to  _s_t_r_i_n_g.   The  comment
  56.               leader  is  printed  before  every log message line
  57.               generated by the keyword $$LLoogg$$ during checkout (see
  58.               ccoo(1)).   This  is useful for programming languages
  59.               without multi-line comments.  An initial ccii ,, or an
  60.               rrccss --ii  without --cc, guesses the comment leader from
  61.  
  62.  
  63.  
  64. GNU                         1991/09/26                          1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RCS(1)                                                     RCS(1)
  71.  
  72.  
  73.               the suffix of the working file.
  74.  
  75.        --kk_s_u_b_s_t
  76.               Set the default keyword substitution to _s_u_b_s_t.  The
  77.               effect  of  keyword  substitution  is  described in
  78.               ccoo(1).  Giving an explicit --kk option to  ccoo,  rrccssdd--
  79.               iiffff,  and  rrccssmmeerrggee overrides this default.  Beware
  80.               rrccss --kkvv, because --kkvv is  incompatible  with  ccoo --ll.
  81.               Use  rrccss --kkkkvv to restore the normal default keyword
  82.               substitution.
  83.  
  84.        --ll[_r_e_v]
  85.               Lock the revision with number _r_e_v.  If a branch  is
  86.               given, lock the latest revision on that branch.  If
  87.               _r_e_v is omitted, lock the  latest  revision  on  the
  88.               default   branch.    Locking  prevents  overlapping
  89.               changes.  A lock is removed with ccii or rrccss --uu  (see
  90.               below).
  91.  
  92.        --uu[_r_e_v]
  93.               Unlock  the  revision with number _r_e_v.  If a branch
  94.               is  given,  unlock  the  latest  revision  on  that
  95.               branch.   If _r_e_v is omitted, remove the latest lock
  96.               held by the caller.  Normally, only the locker of a
  97.               revision  may unlock it.  Somebody else unlocking a
  98.               revision breaks the lock.  This causes a mail  mes-
  99.               sage  to  be sent to the original locker.  The mes-
  100.               sage  contains  a  commentary  solicited  from  the
  101.               breaker.   The  commentary is terminated by end-of-
  102.               file or by a line containing .. by itself.
  103.  
  104.        --LL     Set locking to _s_t_r_i_c_t.  Strict locking  means  that
  105.               the owner of an RCS file is not exempt from locking
  106.               for checkin.  This option should be used for  files
  107.               that are shared.
  108.  
  109.        --UU     Set  locking  to  non-strict.   Non-strict  locking
  110.               means that the owner of a  file  need  not  lock  a
  111.               revision  for  checkin.   This option should _n_o_t be
  112.               used for files that are  shared.   Whether  default
  113.               locking  is  strict  is  determined  by your system
  114.               administrator, but it is normally strict.
  115.  
  116.        --mm_r_e_v::_m_s_g
  117.               Replace revision _r_e_v's log message with _m_s_g.
  118.  
  119.        --nn_n_a_m_e[::[_r_e_v]]
  120.               Associate the symbolic name _n_a_m_e with the branch or
  121.               revision  _r_e_v.   Delete the symbolic name if both ::
  122.               and _r_e_v are omitted; otherwise, print an error mes-
  123.               sage  if  _n_a_m_e  is  already associated with another
  124.               number.  If _r_e_v is symbolic, it is expanded  before
  125.               association.   A  _r_e_v consisting of a branch number
  126.               followed by a  ..  stands  for  the  current  latest
  127.  
  128.  
  129.  
  130. GNU                         1991/09/26                          2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RCS(1)                                                     RCS(1)
  137.  
  138.  
  139.               revision  in  the  branch.   A  :: with an empty _r_e_v
  140.               stands for  the  current  latest  revision  on  the
  141.               default  branch,  normally the trunk.  For example,
  142.               rrccss --nn_n_a_m_e:: RRCCSS//** associates _n_a_m_e with the  current
  143.               latest  revision  of  all the named RCS files; this
  144.               contrasts with rrccss --nn_n_a_m_e::$$ RRCCSS//** which  associates
  145.               _n_a_m_e  with the revision numbers extracted from key-
  146.               word strings in the corresponding working files.
  147.  
  148.        --NN_n_a_m_e[::[_r_e_v]]
  149.               Act like --nn, except override any  previous  assign-
  150.               ment of _n_a_m_e.
  151.  
  152.        --oo_r_a_n_g_e
  153.               deletes (outdates) the revisions given by _r_a_n_g_e.  A
  154.               range consisting of a single revision number  means
  155.               that revision.  A range consisting of a branch num-
  156.               ber means the latest revision on  that  branch.   A
  157.               range of the form _r_e_v_1::_r_e_v_2 means revisions _r_e_v_1 to
  158.               _r_e_v_2 on the same branch, ::_r_e_v means from the begin-
  159.               ning of the branch containing _r_e_v up to and includ-
  160.               ing _r_e_v, and _r_e_v:: means from revision  _r_e_v  to  the
  161.               end of the branch containing _r_e_v.  None of the out-
  162.               dated revisions may have branches or locks.
  163.  
  164.        --qq     Run quietly; do not print diagnostics.
  165.  
  166.        --II     Run interactively, even if the  standard  input  is
  167.               not a terminal.
  168.  
  169.        --ss_s_t_a_t_e[::_r_e_v]
  170.               Set  the  state  attribute  of  the revision _r_e_v to
  171.               _s_t_a_t_e _.  If _r_e_v is a branch number, assume the lat-
  172.               est  revision  on  that branch.  If _r_e_v is omitted,
  173.               assume the latest revision on the  default  branch.
  174.               Any  identifier  is acceptable for _s_t_a_t_e.  A useful
  175.               set of states is EExxpp (for experimental), SSttaabb  (for
  176.               stable), and RReell (for released).  By default, ccii(1)
  177.               sets the state of a revision to EExxpp.
  178.  
  179.        --tt[_f_i_l_e]
  180.               Write descriptive text from  the  contents  of  the
  181.               named _f_i_l_e into the RCS file, deleting the existing
  182.               text.  The _f_i_l_e pathname may not begin with --.   If
  183.               _f_i_l_e  is  omitted,  obtain  the  text from standard
  184.               input, terminated by end-of-file or by a line  con-
  185.               taining .. by itself.  Prompt for the text if inter-
  186.               action is possible; see --II.  With  --ii,  descriptive
  187.               text is obtained even if --tt is not given.
  188.  
  189.        --tt--_s_t_r_i_n_g
  190.               Write descriptive text from the _s_t_r_i_n_g into the RCS
  191.               file, deleting the existing text.
  192.  
  193.  
  194.  
  195.  
  196. GNU                         1991/09/26                          3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. RCS(1)                                                     RCS(1)
  203.  
  204.  
  205.        --VV_n    Emulate RCS version _n.  See ccoo(1) for details.
  206.  
  207.        --xx_s_u_f_f_i_x_e_s
  208.               Use _s_u_f_f_i_x_e_s to characterize RCS files.  See  ccii(1)
  209.               for details.
  210.  
  211. CCOOMMPPAATTIIBBIILLIITTYY
  212.        The  --bb_r_e_v  option  generates  an  RCS file that cannot be
  213.        parsed by RCS version 3 or earlier.
  214.  
  215.        The --kk_s_u_b_s_t options (except --kkkkvv)  generate  an  RCS  file
  216.        that cannot be parsed by RCS version 4 or earlier.
  217.  
  218.        Use  rrccss --VV_n to make an RCS file acceptable to RCS version
  219.        _n by discarding information that would confuse version  _n.
  220.  
  221.        RCS  version  5.5  and  earlier  does  not  support the --xx
  222.        option, and requires a ,,vv suffix on an RCS pathname.
  223.  
  224. FFIILLEESS
  225.        rrccss accesses files much as ccii(1) does, except that it uses
  226.        the effective user for all accesses, it does not write the
  227.        working file or its directory, and it does not  even  read
  228.        the  working  file unless a revision number of $$ is speci-
  229.        fied.
  230.  
  231. EENNVVIIRROONNMMEENNTT
  232.        RRCCSSIINNIITT
  233.               options prepended to the argument  list,  separated
  234.               by spaces.  See ccii(1) for details.
  235.  
  236. DDIIAAGGNNOOSSTTIICCSS
  237.        The RCS pathname and the revisions outdated are written to
  238.        the diagnostic output.  The exit status  is  zero  if  and
  239.        only if all operations were successful.
  240.  
  241. IIDDEENNTTIIFFIICCAATTIIOONN
  242.        Author: Walter F. Tichy.
  243.        Revision Number: 5.6; Release Date: 1991/09/26.
  244.        Copyright (C) 1982, 1988, 1989 by Walter F. Tichy.
  245.        Copyright (C) 1990, 1991 by Paul Eggert.
  246.  
  247. SSEEEE AALLSSOO
  248.        co(1),    ci(1),    ident(1),   rcsdiff(1),   rcsintro(1),
  249.        rcsmerge(1), rlog(1), rcsfile(5)
  250.        Walter  F.  Tichy,  RCS--A  System  for  Version  Control,
  251.        _S_o_f_t_w_a_r_e_-_-_P_r_a_c_t_i_c_e   _&   _E_x_p_e_r_i_e_n_c_e  1155,  7  (July  1985),
  252.        637-654.
  253.  
  254. BBUUGGSS
  255.        The separator for revision ranges in the --oo option used to
  256.        be  --  instead of ::, but this leads to confusion when sym-
  257.        bolic names contain --.  For backwards compatibility rrccss --oo
  258.        still  supports  the  old  -- separator, but it warns about
  259.  
  260.  
  261.  
  262. GNU                         1991/09/26                          4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. RCS(1)                                                     RCS(1)
  269.  
  270.  
  271.        this obsolete use.
  272.  
  273.        Symbolic names need not refer  to  existing  revisions  or
  274.        branches.  For example, the --oo option does not remove sym-
  275.        bolic names for the outdated revisions; you must use --nn to
  276.        remove the names.
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328. GNU                         1991/09/26                          5
  329.  
  330.  
  331.